KCFindNextItem

KCFindNextItem
Header:	Keychain.h		Carbon status:	Under Evaluation

Finds the next keychain item matching the previously specified search criteria.

OSStatus KCFindNextItem (
    KCSearchRef search, 
    KCItemRef *item
);

search: A reference to the current search criteria. Pass the reference passed back in the searchRef parameter of the function KCFindFirstItem.
item: On return, a pointer to the next matching keychain item, if any.

function result: A result code. The result code errKCNoDefaultKeychain indicates that no default keychain could be found. The result code errKCItemNotFound indicates that no matching keychain item was found. The result code errKCInvalidSearchRef indicates that the specified search reference was invalid.

DISCUSSION

The KCFindNextItem function finds the next keychain item matching the search criteria previously specified by a call to KCFindFirstItem. KCFindNextItem returns a reference to the matching item, if any.

SPECIAL CONSIDERATIONS

When you are completely finished with the search, call the functions KCReleaseItem and KCReleaseSearch to release the keychain item reference and search criteria reference, respectively.

VERSION NOTES

Available beginning with Keychain Manager 1.0.

AVAILABILITY

Under evaluation for Carbon. Available in CarbonLib 1.0 and later when KeychainLib 1.0 or later is installed. Exported by CarbonLib 1.0 and later and by KeychainLib 1.0 and later.